Location Properties
Location properties
Property values sit across both sides of locations: an administrator sets them up as part of configuring a location, and service managers can also adjust them from the Working with locations view. Which properties can be edited, and by whom, is controlled per property.
Much of what makes one location different from another comes down to its property values. Centro keeps two kinds of per-location value:
- Centro properties — values of your tenant-wide named properties, set individually for each location (for example a room number, a Wi-Fi password, or a welcome message).
- Device attributes — the per-location values of a device's settings, covered on the Managing locations page.
This page focuses on Centro properties.
What a Centro property is
A Centro property is a named value defined once for your tenant — it has a key, a display name, a description, and a type (text, number, currency, date/time, a yes/no toggle, a password, a selection from a list, and so on). Each location then holds its own value for that property.
The same property key can therefore mean the same thing everywhere — "Wi-Fi password", say — while every room carries its own value.
Setting a property value for a location
An administrator sets property values on the location under General Settings → Objects → Locations:
- Open the location (see Managing locations).
- Find the property you want to set.
- Edit its value and save.
Service managers can also edit a location's property values from their day-to-day view — see Working with locations.
Adding a property to every location at once
When you introduce a new property that every space needs, you can add it to all locations in one step, rather than opening each location in turn. This gives every location the property, ready for you to set each one's value.
How property values are used
A location's property values aren't just stored — Centro puts them to work:
- Devices in the location receive the value, so a property such as a room's Wi-Fi details or a PIN reaches the touchpanels and devices serving that space.
- The app and layouts can display property values in a location's screen.
- QR codes can embed a property's value, so a location's dynamic QR stays in step when the value changes.
- Wallet keys tied to the location are refreshed when a relevant value changes.
Display formatting
Each property can carry a display format (a mask) — for example how a date, a currency amount or a code is shown — applied using the location's locale (its currency symbol, timezone and clock format). So the stored value can be formatted appropriately wherever it appears.
Whether a property can be edited, and by whom (staff, an integration, or the API), is set on the property itself. If a value looks read-only, that property may be locked for editing in your deployment.